Sie befinden sich hier: Software > DOS > Dateien > JJOrdLis > Doku    

Dokumentation von JJORDLIS

Version: 1.02

2003 Feb 16


VORWORT
-------

Vorneweg: JJORDLIS ist Freeware. Die Benutzung geschieht auf
eigene Gefahr. Aus rechtlichen Gruenden garantiere ich fuer nichts.
Eine Aenderung des Sourcecodes und des Programmes sind nicht erlaubt.

JJORDLIS steht fuer Jost Jahns ORDner LISte.

JJORDLIS ist ein kleines DOS-Programm, das alle Ordner eines "dir"
Befehles in eine kurze geoordnete Form bringt. In meinem speziellen
Fall war es die Liste meiner Musik-CDs, die ich gerne immer dabei habe,
wenn ich auf Flohmaerkten nach gebrauchten CDs suche. Schliesslich
moechte ich nicht alles doppelt kaufen, bloss weil ich es schon bei mir
zu Hause habe. Das Programm habe ich dann gleich verallgemeinert.

Merke: Dateien werden ignoriert. Es werden nur Ordner ausgegeben!

Man muss dem Programm JJORDLIS einen String uebergeben, der vom "dir"
Befehl unter DOS verwendet werden kann. Wer mit "dir" Befehl nichts anfangen
kann, sollte JJORDLIS auch nicht verwenden!

Als Beispiel: JJORDLIS.EXE c:\musik\cds /s /o:d

Achtung: Pfadangaben mit Blank muessen in Apostrophe gefasst sein,
also "c:\eigene dateien" statt c:\eigene dateien!

Diesen Befehl fuehrt JJORDLIS dann ueber die Shell aus. Die Syntax
muss korrekt sein, da JJORDLIS den Output dieses Befehls weiterverarbeitet
ueber die Umleitung der Ausgabe in eine Datei. JJORDLIS meldet aber
voelligen Unsinn, der keine sinnvolle Ausgabe (Leerausgabe) erzeugt.

Im obigen Beispiel werden alle Ordner aufgelistet inkl. alle eingebetteten
Unterordner.

JJORDLIS erzeugt drei interne Dateien, die zur Zeit nicht geloescht werden,
um die Fehleranalyse zu verinfachen:
JJORDLIS.DUM JJORDLIS.DVM und JJORDLIS.DWM.

Die Datei JJORDLIS.OUT ist der fertige Output.

In diesem Output stehen alle Ordner inkl. der Unterordner alphabetisch
sortiert. Dabei sind Unterordner, die Teilstrings vom Oberordner enthalten
gekuerzt dargestellt.

Beispiel:

c:\musik\cds enthaelt den Ordner "Bravo Hits". Dieser Ordner enthaelt
die Ordner "Bravo Hits 1997" und "Bravo Hits 1998". Als Ergebnis steht
im Output:

Bravo Hits
- 1997
- 1998

Diese stark gekuerzte Datei JJORDLIS.OUT transferiere ich dann
auf meinem Palm mit "isilo", wobei das Ganze einmal am Tage ueber
den Scheduler automatisch ablaeuft.

Im zweifel probieren Sie es einfach mal aus, was herauskommt.

Warum unter DOS?
Nun, ich programmiere in QBasic gerne einen schnellen Hack,
der sich dann auch mal ausweiten kann. Ausserdem benutze ich gerne
Batches, um meine Daten zu verarbeiten. Da bieten sich DOS-Utilities
eben an.


INSTALLATION
------------

Entpacken Sie alle Dateien in ein Verzeichnis Ihrer Wahl.


BENUTZUNG
---------

Beim Start unter DOS muss dem Programm ein "dir" Kommando uebergeben
werden (s.o). Diese Ausfuehrung kann sehr lange dauern, wenn es sehr
viele Unterverzeichnisse gibt (evtl. etliche Minuten oder Stunden bei
einer 100 GB Platte!). Man sollte nicht zu viele Ordner uebergeben,
da der DOS-eigene Sort-Befehl, der verwendet wird nur 64 KB verarbeiten
kann. Im Zweifelsfalle bekommt man eine Fehlermeldung von JJORDLIS.
Dann muss man das Verzeichnis anders strukturieren.

Im Ordner werden die Dateien JJORDLIS.DUM, JJORDLIS.DVM und JJORDLISL.DWM
angelegt, die nach Beendigung des Programmes zur Zeit nicht geloescht werden.

Der Ordner, wo JJ-HTML startet muss natuerlich schreibberechtigt sein!

Es wird ein Protokoll ausgegeben. Sonderzeichen werden umgewandelt
(a-Umlaut z.B. in ae) bzw. angezeigt, wenn nicht beruecksichtigt.


WEBSEITE
--------

Die Software liegt unter http://www.jostjahn.de/software/jjordlis.zip
Diese Datei liegt unter http://www.jostjahn.de/software/jjordlis.html

Sollten diese beiden Webseiten nicht erreichbar sein, schauen
Sie im Index von http://www.jostjahn.de nach.

Unter http://www.jostjahn.de/software/softnews.html koennen Sie sich
auch in einen Newsletter eintragen lassen, der Ihnen Updates mitteilt.


BUGS
----

Bei sehr grossen Verzeichnissen listet der dir Befehl nicht alle
Verzeichnisse auf. Dann kann JJORDLIS auch nicht alles ausgeben.


KONTAKT
-------

Verbesserungsvorschlaege und Fehlermeldungen senden Sie bitte
an webmaster@jostjahn.de


BEISPIEL
--------

Siehe oben